home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / syr2.z / syr2
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  100 lines
  1. SYR2(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSYYRR22, DDSSYYRR22 - Performs symmetric rank 2 update of a real symmetric
  6.      matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSYYRR22 ((_u_p_l_o,, _n,, _a_l_p_h_a,, _x,, _i_n_c_x,, _y,, _i_n_c_y,, _a,, _l_d_a))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDSSYYRR22 ((_u_p_l_o,, _n,, _a_l_p_h_a,, _x,, _i_n_c_x,, _y,, _i_n_c_y,, _a,, _l_d_a))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      These routines perform the following symmetric rank 2 operation:
  22.                        _T           _T
  23.           _A <- _a_l_p_h_a _x_y  + _a_l_p_h_a _y_x  + _A
  24.                                     _T                         _T
  25.      where _a_l_p_h_a is a real scalar, _y  is the transpose of _y, _x  is the
  26.      transpose of _x, _x and _y are _n-element vectors, and _A is an _n-by-_n real
  27.      symmetric matrix.
  28.  
  29.      This routine has the following arguments:
  30.  
  31.      _u_p_l_o      Character*1.  (input)
  32.                Specifies whether the upper or lower triangular part of
  33.                matrix _A is being supplied, as follows:
  34.  
  35.                _u_p_l_o= 'U' or 'u':  only the upper triangular part of array _a
  36.                is referenced.
  37.                _u_p_l_o= 'L' or 'l':  only the lower triangular part of array _a
  38.                is referenced.
  39.  
  40.      _n         Integer.  (input)
  41.                Specifies the order of matrix _A.  _n >= 0.
  42.  
  43.      _a_l_p_h_a     Scalar alpha.  (input)
  44.                SSSSYYRR22: Real.
  45.                DDSSYYRR22: Double precision.
  46.  
  47.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input)
  48.                SSSSYYRR22: Real array.
  49.                DDSSYYRR22: Double precision array.
  50.  
  51.      _i_n_c_x      Integer.  (input)
  52.                On entry, _i_n_c_x specifies the increment for the elements of
  53.                _x.  _i_n_c_x must not be 0.
  54.  
  55.      _y         Array of dimension 1+(_n-1) * |_i_n_c_y|.  (input)
  56.                SSSSYYRR22: Real array.
  57.                DDSSYYRR22: Double precision array.
  58.  
  59.      _i_n_c_y      Integer.  (input)
  60.                On entry, _i_n_c_y specifies the increment for the elements of
  61.                _y.  _i_n_c_y must not be 0.
  62.  
  63.      _a         Array of dimension (_l_d_a,_n).  (input and output)
  64.                SSSSYYRR22: Real array.
  65.                DDSSYYRR22: Double precision array.
  66.  
  67.                Before entry with  _u_p_l_o='U' or 'u', the leading _n-by-_n upper
  68.                triangular part of array _a must contain the upper triangular
  69.                part of the symmetric matrix and the strictly lower
  70.                triangular part of _a is not referenced.  On exit, the upper
  71.                triangular part of the updated matrix overwrites the upper
  72.                triangular part of array _a.
  73.  
  74.                Before entry with _u_p_l_o='L' or 'l', the leading _n-by-_n lower
  75.                triangular part of array _a must contain the lower triangular
  76.                part of the symmetric matrix and the strictly upper
  77.                triangular part of _a is not referenced.  On exit, the lower
  78.                triangular part of the updated matrix overwrites the lower
  79.                triangular part of array _a.
  80.  
  81.      _l_d_a       Integer.  (input)
  82.                Specifies the first dimension of _a as declared in the
  83.                calling program.  _l_d_a >= MMAAXX(1,_n).
  84.  
  85. NNOOTTEESS
  86.      SSSSYYRR22/DDSSYYRR22 is a Level 2 Basic Linear Algebra Subprogram (Level 2
  87.      BLAS).
  88.  
  89.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), this routine starts at
  90.      the end of the vector and moves backward, as follows:
  91.  
  92.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)) , ..., _x(1)
  93.  
  94.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)) , ..., _y(1)
  95.  
  96. SSEEEE AALLSSOO
  97.      HHEERR22(3F)
  98.  
  99.      This man page is available only online.
  100.